Release 10.1A: OpenEdge Development:
Progress 4GL Reference

START-ELEMENT( ) method

Starts an XML node based upon the name of the node in a SAX-writer object.

Return type: LOGICAL

Applies to: SAX-writer object handle

Syntax

START-ELEMENT( name [, namespace-URI ] )

name

A LONGCHAR expression evaluating to the fully qualified or unqualified name of the element.

namespace-URI

A LONGCHAR expression evaluating to the URI of the element, or an empty string ("") or the Unknown value (?) if the element doesn’t contain a namespace.

Starts an XML node. This method call changes the WRITE-STATUS to SAX-WRITE-TAG.

For every call of the START-ELEMENT method, there must be a following corresponding call of the END-ELEMENT method. All the parameter values from the two calls must match for the methods to correspond.

If namespace-URI is present, then the prefix will be resolved in the following order:

The method attempts to extract the namespace from the name.
The method attempts to extract the namespace from a previously declared namespace.
The method attempts to generate the default namespace.

If the name contains a prefix, namespace-URI is present, and this is the first instance of the namespace-URI, then the namespace is added to the element. This technique is equivalent to calling the DECLARE-NAMESPACE method.

If only the name is present and it contains a prefix, then the SAX-writer attempts to resolve the prefix to a namespace.

If the STRICT attribute is TRUE, the FRAGMENT attribute is FALSE, and the call would result in more than one document-level element (that is, root node), then the method fails. Also, if STRICT is TRUE, an external DTD has been declared, and the call would create the root node, then the name used for the DTD declaration must match the name of the root node or the method fails.

See also

END-ELEMENT( ) method